PATHMac OS 8 Developer Documentation > Networking and Communications > AppleShare >

User Authentication Modules

UAMGetAttribute

Obtain the value of an attribute.



 
extern UInt32 UAMGetAttribute 

                     (OAMObjectSpec *spec,

                     OSType creator,

                     OSType type,

                     void *buffer,

                     UInt32* size);

spec: Specifies the OAMObjectSpec for which the value of an attribute is to be obtained. For information about the OAMObjectSpec structures, see The AppleShare Registry Library , which is provided as part of the AppleShare IP 6.1 Developer's Kit .
creator: Specifies the creator code of the attribute whose value is to be obtained. For information about the attribute creator codes defined by Apple Computer, see The AppleShare Registry Library , which is provided as part of the AppleShare IP 6.1 Developer's Kit .
type: Specifies the type code of the attribute whose value is to be obtained. For information about the attribute type codes defined by Apple Computer, see The AppleShare Registry Library , which is provided as part of the AppleShare IP Developer's Kit.
buffer: On output, contains the value of the attribute identified by spec , creator , and type .
size: On input, specifies the length of buffer . On output, specifies the length of the data in buffer .
function result: A result code. For a list of possible values, see Result Codes .

DISCUSSION

The UAMGetAttribute function obtains the value of the attribute identified by the value of the spec , creator , and type parameters.

In the following code sample, the UAM calls UAMGetAttribute to obtain the user name attribute:



 
STr32   userName;

UAMGetAttribute(id,kUser,kName,&userName,sizeof(Str32));